home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / diet145f.zip / DIET145F.DOC < prev    next >
Text File  |  1992-10-25  |  31KB  |  786 lines
  1.  
  2.   ------------------------------------------------------------
  3.                   DIET.DOC for DIET.EXE v.1.45F
  4.               ------  by Teddy Matsumoto ---------
  5.                     (DOCFILE: October 1992)
  6.   ------------------------------------------------------------
  7.  
  8.  
  9. 1.0.  OVERVIEW.
  10.  
  11. 1.1.  DIET.EXE reduces the disk-storage space needed by ex-
  12. ecutable and data files WITHOUT giving up immediate access to
  13. such files.  DIET is a Freeware Program.
  14.  
  15.   (a)   When DIET compresses an EXECUTABLE file (.EXE or .COM),
  16.         it adds a header that automatically expands the file when
  17.         it is executed.
  18.  
  19.   (b)   On average, DIET reduces the size of .EXE & .COM files
  20.         by 40%.
  21.  
  22.   (c)   Self-expansion of DIETed .EXE & .COM files is so fast
  23.         that it is difficult to measure the change in the speed
  24.         of file execution.  You certainly won't notice any
  25.         change.
  26.  
  27.   (d)   DIET's self-expansion of .EXE and .COM files is similar
  28.         to PKLITE or LZEXE, except that DIET also lets you com-
  29.         press overlay files -- something that PKLITE and LZEXE
  30.         cannot do.
  31.  
  32.  
  33. 1.2.  What makes DIET really unique is its ability to compress
  34. DATA Files and to automatically expand them when you call them
  35. into an Word Processor or Editor to read or change them.
  36.  
  37.   (a)   To use that feature, you must load DIET so that it is
  38.         resident in memory (i.e., Terminate and Stay Resident, or
  39.         TSR).
  40.  
  41.   (b)   DIET reduces the size of an average DATA File by 2/3rd.
  42.  
  43.   (c)   DIET's automatic expansion of Data Files adds a little
  44.         time (on a 386SX-16 system, about 3 sec. compared to
  45.         loading a 100k byte unDIETed text file into an editor).
  46.         But that is a small price for the benefit of being able
  47.         to keep infrequently-used Data Files on your Hard Disk,
  48.         instead of having to store them on floppies. And you can
  49.         optionally set up DIET so that it will automatically
  50.         recompress Data Files when you exit your Editor.
  51.  
  52.   (d)   Many -- but not all -- application programs can use
  53.         DIETed DATA files.  For example, QUATTRO can use DIETed
  54.         ???.WQ1 files; dBASE cannot use DIETed ???.DBF files.
  55.         You'll have to experiment.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105. This document is the USER'S GUIDE for DIET v.1.45F.  To learn
  106. about DIET's internals and changes from version to version, see
  107. DIETAPI.DOC and DIETTECH.DOC  Those much more technical documents
  108. are of no importance to the average USER of DIET, but are avail-
  109. able for programmers and the curious.
  110.  
  111.  
  112.  
  113. 2.0.  A QUICK INTRODUCTION TO WHAT DIET CAN DO.
  114.  
  115.  
  116. 2.1.  OVERVIEW.  For our discussion, it is useful to classify
  117. DOS files into three general types:
  118.  
  119.  
  120.        ∙  EXECUTABLE, i.e., ???.EXE and ???.COM
  121.  
  122.  
  123.        ∙  DEVICE DRIVERS, e.g., ???.SYS or ???.DRV
  124.  
  125.  
  126.        ∙  DATA, e.g. ???.DOC, ???.TXT, ???.WQ1, etc.
  127.  
  128.  
  129. 2.1.1.  DIET compresses EXECUTABLES and DRIVERS so that from the
  130. user's perspective they perform the same as if they were not
  131. compressed.  That means you can execute them directly, or load
  132. them from your CONFIG.SYS.  We call this feature selF-eXtracting,
  133. or SFX.
  134.  
  135.  
  136. 2.1.2.  You can use DIET to compress DATA-type files, but they
  137. are NOT self-extracting.  To use DIETed DATA files, you must
  138. either decompress manually or load DIET as a TSR so that they are
  139. decompressed automatically when your application program loads
  140. them.
  141.  
  142.  
  143. 2.1.3.  To compress your files on the current directory, simply
  144. type:
  145.                          DIET filename,
  146. or use wildcards, e.g.,
  147.                             DIET *.*
  148. When you use DIET without any options, EXECUTABLES and DRIVERS
  149. are compressed as SFX, and all other files as non-SFX types
  150. files.
  151.  
  152.  
  153. 2.1.4.  To know whether or not a file has been compressed by
  154. DIET, type:
  155.                              DIET -l
  156. That will display all files in the current directory, with com-
  157. pressed files in reverse color.
  158.  
  159.  
  160. 2.1.5.  To restore non-SFX compressed files to their uncompressed
  161. status, type
  162.              DIET -r filename.ext,  or  DIET -r *.*
  163.  
  164.  
  165. 2.1.6.  The simplest -- but not best -- use of DIET would be to
  166. execute both of the following commands in a directory:
  167.                             DIET *.*
  168. followed by
  169.                            DIET -r *.*
  170. That would leave you with EXECUTABLES and DRIVERS in SFX mode,
  171. and all other files (the DATA-type files) uncompressed.
  172.  
  173.  
  174. To restore all DIETed files, including compressed executable or
  175. driver files, type
  176.              DIET -ra filename.ext  or  DIET -ra *.*
  177.  
  178.  
  179. 2.2.  DIET in TSR Mode.
  180. We assume you're displaying DIET.DOC on your console, using
  181. the DOS MORE command, Vernon Buerg's LIST.COM, or your favorite
  182. Editor.  Try the following:
  183.  
  184.  
  185.   (a)   Return to DOS.
  186.  
  187.  
  188.   (b)   Execute:
  189.                             DIET DIET.DOC
  190.         That will compress this file.  If you now try view the
  191.         file with MORE, or read it with LIST or your favorite
  192.         editor, you'll get garbage.
  193.  
  194.  
  195.   (c)   Now Execute:
  196.                                  DIET -Z
  197.         That will load DIET in the TSR mode and allows you to
  198.         display DIET.DOC with MORE, LIST, or your Editor.  Try
  199.         it.
  200.  
  201.  
  202.   (d)   Remove the DIET TSR by executing:
  203.                                 DIET -ZR
  204.  
  205.  
  206.   (e)   Finally, restore (i.e., decompress) DIET.DOC by
  207.         executing:
  208.                            DIET -R DIET.DOC
  209.  
  210.  
  211.  
  212. 3.0.  USING DIET's OPTIONS
  213.  
  214.  
  215. 3.1.  The basic DIET command structure is:
  216.                    DIET [options] [file-names]
  217.                 {wild-cards are OK in filenames}
  218. Options require a prefix.  You may use either "-" or "/" as the
  219. option-prefix.  Multiple options must be separated by spaces,
  220. e.g.
  221.                        DIET -z -p -td:\tmp
  222.  
  223.  
  224.  
  225. 3.2.  Options fall into two general categories:
  226.  
  227.  
  228.   (a)   BASIC options that specify fundamental DIET functions,
  229.         and
  230.  
  231.  
  232.   (b)   AUXILIARY Options that modify the operation of a BASIC
  233.         option.
  234.  
  235.  
  236. 3.3.  The following table summarizes the BASIC and AUXILIARY
  237. Options:
  238.  
  239.  ------------------------------------------------------------------
  240.  BASIC      Function of the           AUXILIARY Options that can
  241.  Option     BASIC Option              Be used with the BASIC option
  242.  ------------------------------------------------------------------
  243.  DIET w/o   Compress the named           -X,-XC,-G,-D,-B,-K,-I,-A
  244.   option    files                        -E, -Oxxxxx.
  245.  ------------------------------------------------------------------
  246.  -R,-RA     Decompress named files       -Oxxxxx.
  247.  ------------------------------------------------------------------
  248.  -Cxxxxx    Copy without                 -R,-RA,-A
  249.             decompress/recompress
  250.  ------------------------------------------------------------------
  251.  -L         Identify compressed files.
  252.  -H         Check integrity of compressed file, using CRC
  253.  ------------------------------------------------------------------
  254.  -!         Check DIET's own validity
  255.  -?         Display Help Screen.
  256.  -$         Compress later (see -N)
  257.  ------------------------------------------------------------------
  258.  -Z[n]      Load DIET as a TSR. Value    -P,-W,-N,-M
  259.             of [n] defines where in      -S,-Txxxxxx
  260.             memory DIET is loaded.
  261.  ------------------------------------------------------------------
  262.  -ZD        Disable TSR DIET  (also DIET OFF)
  263.  -ZA        Activate TSR DIET (also DIET ON)
  264.  -ZR        Remove TSR DIET from memory.
  265.  ------------------------------------------------------------------
  266.  
  267.  
  268.  
  269. 3.4.  The following table summarizes what the file-related
  270. AUXILIARY options do.  Not included in the table are the
  271. AUXILIARY options related to TSR-user of DIET -- they are dis-
  272. cussed at xx, below.  For more details on options, see the full
  273. discussion of options at xx, below.
  274.  
  275.                    SUMMARY of what FILE-RELATED OPTIONS do.
  276.                -X     Compress as SFX type.
  277.               -XC     Force compression of a .COM file as a real SFX .COM file
  278.